| CFTREEITEM |
|
 |
| Description
|
|
Populates a form tree control, created with the cftree tag, with elements. To display icons, you can use the img values that ColdFusion provides, or reference your own icons.
|
| |
| Category
|
|
Forms tags
|
| |
Syntax<cftreeitem
value = "text"
display = "text"
parent = "parent_name"
img = "filename"
imgopen = "filename"
href = "URL"
target = "URL_target"
query = "queryname"
queryAsRoot = "Yes" or "No"
expand = "Yes" or "No">
|
| |
| See also
|
|
cfapplet, cfform, cfgrid, cfgridcolumn, cfgridrow, cfgridupdate, cfinput, cfselect, cfslider, cftextinput, cftree
|
|
|
| |
| Usage
|
|
This tag requires the client to download a Java applet. Downloading an applet takes time; therefore, using this tag might be slightly slower than using an HTML form element or the cfinput tag to get the same information.
|
|
For this tag to work properly. the browser must be JavaScript-enabled.
|
| |
Example<!--- This example shows the use of cftreeitem in cfform. Query takes
employee list, and uses cftree and cfselect to display query results.
Shows an alternate means of displaying the data --->
<!--- set a default for the employeeNames variable --->
<cfparam name = "employeeNames" default = "">
<!--- if an employee name has been passed from the form, set employeeNames
variable to this value ---Auto>
<cfif IsDefined("form.employeeNames")>
<cfset employeeNames = form.employeeNames>
</cfif>
<!--- query the datasource to find the employee information--->
<cfquery name = "GetEmployees" dataSource = "cfsnippets">
SELECT Emp_ID, FirstName, LastName, EMail, Phone, Department
FROM Employees
WHERE 0=0
<cfif employeeNames is not "">
AND LastName = '#employeeNames#'
</cfif>
</cfquery>
<!--- Use cfform when using other cfinput tools --->
<cfform action = "cfindex.cfm">
<!--- Use cfselect to present the contents of the query by column --->
<h3>cfselect Presentation of Data</h3>
<h4>Click an employee's last name and click "see information for this employee"
to see expanded information.</h4>
<cfselect name = "EmployeeNames" message = "Select an Employee Name"
size = "#getEmployees.recordcount#" query = "GetEmployees"
value = "LastName" required = "No">
<option value = "">Select All
</cfselect>
<input type = "Submit" name = ""
value = "see information for this employee">
<!--- showing use of cftree for expanded presentation of data --->
<!--- Loop through the query to create each branch of the cftree --->
<h3>cftree Presentation of Data</h3>
<h4>Click the folders to "drill down" and reveal information.</h4>
<p>cftreeitem is used to create the branches of the cftree.
<p><cftree name = "SeeEmployees" height = "150" width = "240"
font = "Arial Narrow" bold = "No" italic = "No" border = "Yes"
hScroll = "Yes" vScroll = "Yes" required = "No" completePath = "No"
appendKey = "Yes" highlightHref = "Yes">
<cfloop query = "GetEmployees">
<cftreeitem value = "#Emp_ID#" parent = "SeeEmployees" expand = "No">
<cftreeitem value = "#LastName#" display = "Name"
parent = "#Emp_ID#" queryAsRoot = "No" expand = "No">
<cftreeitem value = "#LastName#, #FirstName#"
parent = "#LastName#" expand = "No" queryAsRoot = "No">
<cftreeitem value = "#Department#" display = "Department"
parent = "#Emp_ID#" queryAsRoot = "No" expand = "No">
<cftreeitem value = "#Department#"
parent = "#Department#" expand = "No" queryAsRoot = "No">
<cftreeitem value = "#Phone#" display = "Phone"
parent = "#Emp_ID#" queryAsRoot = "No" expand = "No">
<cftreeitem value = "#Phone#"
parent = "#Phone#" expand = "No" queryAsRoot = "No">
<cftreeitem value = "#Email#" display = "Email"
parent = "#Emp_ID#" queryAsRoot = "No" expand = "No">
<cftreeitem value = "#Email#"
parent = "#Email#" expand = "No" queryAsRoot = "No">
</cfloop>
</cftree>
<!--------For a more comprehensive, quicker view, you can use CFGRID ------->
<h3>cfgrid Presentation of Data</h3>
<cfgrid name="SampleGrid" width="600" query="GetEmployees" insert="No"
delete="No" sort="No" font="Verdana" bold="No" italic="No" appendkey="No"
highlighthref="No" griddataalign="LEFT" gridlines="Yes" rowheaders="No"
rowheaderalign="LEFT" rowheaderitalic="No" rowheaderbold="No"
colheaders="Yes"
colheaderalign="CENTER" colheaderitalic="No" colheaderbold="No"
bgcolor="Teal" selectmode="BROWSE" picturebar="No">
<cfgridcolumn name="LastName" header="Last Name" headeralign="LEFT"
dataalign="LEFT" bold="No" italic="No" select="Yes" display="Yes"
headerbold="No" headeritalic="No"> <cfgridcolumn name="FirstName"
header="First Name" headeralign="LEFT" dataalign="LEFT" fontsize="2"
bold="No" italic="No" select="No" display="Yes" headerbold="No"
headeritalic="No">
<cfgridcolumn name="Email" header="Email" headeralign="LEFT" dataalign="LEFT"
bold="No" italic="No" select="No" display="Yes" headerbold="No"
headeritalic="No">
<cfgridcolumn name="Phone" header="Phone" headeralign="LEFT" dataalign="LEFT"
bold="No" italic="Yes" select="No" display="Yes" headerbold="No"
headeritalic="No"> <cfgridcolumn name="Department" header="Department"
headeralign="LEFT" dataalign="LEFT" bold="Yes" italic="No" select="No"
display="Yes" headerbold="No" headeritalic="No">
<cfgridcolumn name="Emp_ID" header="ID" headeralign="LEFT" dataalign="LEFT"
width="40" bold="No" italic="No" select="No" display="Yes" headerbold="No"
headeritalic="No">
</cfgrid>
</cfform>
|